Integrating an XForm with WS-AppServer

This topic describes the procedure to integrate Process Platform XForms with WS-AppServer.

1. Open the XForm in the XForms Designer.
2. Select the required Web service operation in the Insert tab and drag it to the XForms Designer. Alternately, right-click the Designer Area, and select Insert Web Service to view available Web services and add the required one to the XForm. The Generate Input and Output UI dialog box appears.
3. Make appropriate modifications and click OK:
   • Select a service from the Services drop-down list.
   • Select a port from the Ports drop-down list.
   • Select the action to perform from the Operations drop-down list.
   • Select Generate UI for Input message to generate the input UI.
   • Select Generate UI for Output message to generate the output UI. The UI is displayed in the Designer Area.
4. Select Advanced in the toolbar to view advanced options.
5. Click (Manage Models) in the toolbar. The Manage Models window appears.
6. Select the model and click . Alternately, click the model name. The Model Properties dialog box appears.
7. Select the WS-AppServer Integration check box. The WS-AppServer tab appears.
8. Make appropriate modifications in the WS-AppServer tab and click OK:
   • Check Apply Access Control to enable, disable, hide, or display controls in an XForm based on the business logic available in the WS-AppServer.
   • Check Initialization Required to provide default values for controls in the XForm when a new record is added to it.
   • Check Constraint Validation to enable server-side validation of data that is displayed in the XForm.
   • Select an option from the Before Validation drop-down list to specify the Web service operation to be executed before the validate request is sent to the WS-AppServer.
   • Select an option from the After Validation drop-down list to specify the Web service operation to be executed after the validate request is sent to the WS-AppServer.
9. Double click a control on the XForm to define its integration properties. The <control> window appears.

   Note:
   You can integrate only the Input, Password, Textarea, Check, and Select controls.

10. Select the model in the Model field of the <control> window. The WS-AppServer Properties pane appears.
11. Click to expand the WS-AppServer Properties pane and make appropriate modifications:
    • Select Constraint Validation on Change to enable validation of changes made to specific controls on the XForm.
    • Select Never, Always, or Once from the Initialize Value Sets drop-down list to specify how to prefill the Select control with content, using the application logic.

      Note:

      • The Initialize Value Sets option is available only for the Select control. For a Select control, the request to retrieve data is sent only when the control is highlighted and only if the data node exists.
      • The qValues attribute is used to initialize value sets in WS-AppServer for Select controls.
12. Click .

The changes made to the XForm are saved and the XForm is integrated with the WS-AppServer.